ingenious.V12
XML Export per Web-Request
Updates > Jahresupdate 2019 -> 2020 > Neue Funktionen > XML Export per Web-Request

Für den Export von Artikel-, Kontakte- und Projektdatensätzen zur Weiterverwendung in Web-Anwendungen steht eine Schnittstelle zur Verfügung, die einmalig in den Programmeinstellungen konfiguriert wird und über einen Web-Request gestartet wird.

Für jedes der 3 möglichen Module steht ein separater Konfigurationsbereich zur Verfügung.

 

Für die Suche per Web-Request wird ein Datenbankfeld festgelegt. Der Suchstring kann so genannte Wildcards enthalten, möglich sind "*" oder "@". Nach diesem Feld werden die exportierten Datensätze außerdem sortiert. Per Doppelklick auf das Feld "Suchen nach" öffnet die Feldauswahl, über die das gewünschte Feld ausgewählt werden kann.

 

Definition des Such-Strings

Definition des Such-Strings

 

Umfang und Inhalt der XML Ausgabedatei sind frei definierbar. Die XML-Knoten können entsprechend der Anforderungen der externen Anwendung frei benannt werden und können feste Werte, Datenbankfelder, Formeln und Benutzerfelder (über eine Formel) enthalten.

 

XML-Knoten Ausgabewert
fix abc
feld [Kontakte]KundenNr
formel [Kontakte]Strasse+", "+[Kontakte]PLZ+" "+[Kontakte]Ort
benutzer_feld BF_GetText ([Kontakte]OID;"ContactStatus")

 

Ein neuer Knoten wird über den  Button hinzugefügt. Per Doppelklick auf die Zeile öffnet ein Editor, über den die Bezeichnung des Knotens und der Datentyp ausgewählt werden. Ein fester Wert kann direkt in das entsprechende Feld geschrieben werden. Für die Verwendung eines Feldes oder einer Formel öffnet per Doppleklick auf das Feld "Wert" ein weiterer Dialog.

 

Knoten Konfiguration für ein Datenbankfeld

Knoten Konfiguration für ein Datenbankfeld

 

Innerhalb eines XML-Knotens sind einzeilige Formeln möglich. Komplexere Formeln müssen per Skript gebildet und über ‘EXEC_Script({script_name}{;param1{;param2;…}})’ eingefügt werden.

 

Knoten Konfiguration für eine Formel 

Knoten Konfiguration für eine Formel 

 

Benutzerfelder werden über die API Funktion ‘BF_GetText({record-ID};{user field name})’ geladen.

 

Knoten Konfiguration für ein Benutzerfeld

Knoten Konfiguration für ein Benutzerfeld

 

Um einen XML Knoten zu ändern, wird doppelt auf die entsprechende Zeile geklickt. Gelöscht wird ein XML-Knoten über den Button .

 

Web-Aufruf

 

Über die URL {ingenious.V12 webserver}/xml_export&module={module}&select={searchstring} wird der Web-Aufruf gestartet.

{ingenious.V12 webserver} steht für die Web-Adresse bzw. IP des eigenen Webservers.

Für {module} wird das Modul eingetragen, in dem gesucht werden soll.

Für {searchstring} ist der Suchbegriff einzutragen. Dieser kann die Wildcards "*" und "@" enthalten, die für unbekannte Zeichen im Suchbegriff stehen.

 

Der Web-Aufruf erzeugt eine XML mit folgendem Aufbau:

 

Web Aufruf XML
Kopiere Code
<?xml version="1.0" encoding="UTF-8" standalone="no" ?>
<xml_export records="{Anzahl exportierte Datensätze}">
<record num="{Datensatz Nummer}">
<{Generischer XML Knoten 1}>
{Exportierter Wert 1}
</{Generischer XML Knoten 1}>
<{Generischer XML Knoten 2}>
{Exportierter Wert 2}
</{Generischer XML Knoten 2}>
{ ... }
</record>
{ ... }